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INTRODUCTION 


ELLA  Is  a  Hardware  Design  and  Description  Language  that  has  been  developed 
at  RSRE  over  the  past  eight  years.  It  allows  the  user  to  form  a 
description  of  a  circuit  (at  different  levels  of  abstraction)  and  then  to 
simulate  his  description.  If  there  is  a  discrepancy  between  the  simulator 
output  and  the  expected  output,  then  he  can  alter  the  ELLA  description  of 
his  hardware  model  and  re-simulate.  It  Is  therefore  important  that  the 
simulator  has  a  good  user-interface:  in  particular,  that  the  output  is  in  a 
form  which  can  be  easily  read  and  compared  with  the  expected  output.  This 
memo  describes  a  form  of  output  -  tabular  output  -  which  is  an  alternative 
to  the  current  output. 

The  interactive  tabular  might  be  preferred  to  the  existing  simulator  for 
analysing  ELLA  output  for  four  main  reasons.  Firstly,  when  a  number  of 
different  points  in  the  circuit  are  being  monitored  simultaneously,  it  is 
easier  to  follow  the  changes  of  one  particular  monitor  point,  since  the 
different  values  it  takes  up  are  all  placed  in  the  same  column.  Secondly, 
if  a  monitor  point  is  a  complex  ELLA  structure,  consisting  of  a  number  of 
different  fields,  then  it  is  possible  to  select  Individual  elements  of  the 
structure,  whereas  in  the  current  simulator,  all  fields  would  have  to  be 
displayed.  Thirdly,  there  is  a  facility  for  searching  for  all  occurrences 
of  an  event  or  combination  of  events  and  finally,  there  is  the  possibility 
of  renaming  basic  values  in  the  tabulator;  this  can  be  used  to  generate 
simple  waveforms  as  described  in  Section  3.4. 

The  two  different  output  formats  are  compared  in  the  appendix,  in  which  the 
same  information  is  shown  in  the  output  format  of  the  current  simulator 
(APPENDIX  1)  and  in  tabular  form  (APPENDIX  2). 

The  tabulator  is  written  in  ALGOL  68  (like  the  rest  of  the  ELLA  system)  and 
uses  a  syntax  manipulator  called  SID [ 1 ] ;  this  enables  new  commands  to  be 
added  and  existing  ones  to  be  altered  with  the  minimum  of  effort.  It  was 
originally  written  as  a  post-processor  quite  separate  from  the  rest  of  the 
ELLA  system,  whereas  now  it  is  being  fully  Integrated  as  an  interactive 
facility.  This  report  describes  the  facilities  of  the  post-processor 
because  the  definition  of  the  interactive  system  has  not  yet  stabilised. 
The  differences  between  the  two  are  expected  to  be  of  a  mainly  cosmetic 
nature  though;  the  current  version  of  the  interactive  system  is  described 
in  Chapter  17  of  the  ELLA  User  Manual  [2]. 

2.  SIMULATOR  COMMANDS 

The  tabulator  uses  data  stored  by  the  simulator  in  a  history  file;  this 
Includes  information  about  the  ELLA  TYPES  used  and  changes  in  value  of  the 
monitor  points  that  have  been  kept.  The  simulator  commands  needed  to 
produce  a  history  file  which  is  to  be  used  by  the  tabulator  are  described 
below. 


2.1  History 

History  enables  the  user  to  name  the  history  file  which  is  created  by  the 
simulator;  the  command 


history  histflle 
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produces  the  history  file  hlstflle.  If  no  history  command  is  given,  a 
default  filename  is  used:  for  example,  on  VAX,  if  the  user's  ELLA  library 
is  zzzllb.ell,  then  the  default  history  file  will  be  zzzlllb.elh. 


2.2  Tabulate 

Tabulate  is  used  to  enter  the  tabulator.  For  example 
tabulate  histfile 

will  enter  the  tabulator  with  the  history  file  histfile.  If  the  tabulate 
command  is  given  from  the  simulator  and  no  filename  is  given,  the  tabulator 
will  use  the  history  file  that  has  been  opened  by  the  simulator. 


2.3  mk 

mk  (monitor  keep)  is  used  to  name  the  monitors  to  be  used  in  the  tabulator. 
The  command  ha6  the  same  form  as  the  me  command  and  like  me,  only  changes 
in  value  of  the  named  monitors  are  recorded. 


3.  TABULATOR  COMMANDS 

The  tabulator  is  an  Interactive  system,  which  sends  output  to  the  screen  by 
default.  Output  is  produced  by  a  window  command  (see  Section  3.3),  which 
displays  all  monitor  points  which  have  been  given  as  parameters  to  a  dp 
command  (Section  3.1).  A  number  of  monitor  points  can  be  specified  by  a 
single  name  (see  Section  3.2).  Individual  monitor  points  unfortunately 
cannot  be  deleted  at  the  moment;  there  is  only  a  command  to  delete  all 
existing  monitors  -  clear  display  (see  Section  3.2). 


3.1  d£ 

dp  (display)  followed  by  one  or  more  monitors  adds  those  monitors  to  the 
list  of  monitors  currently  being  displayed. 

Monitors  can  be  Indexed  in  a  similar  way  to  the  indexing  of  ELLA 
structures.  For  example,  if  monl  is  a  structure  identifier  of  TYPE  [8] 
bool,  then 

dp  monl  [1] 

will  display  the  first  element  of  the  [8]  bool  structure, 
dp  monl  [1..4] 

will  display  the  first  four  elements  of  monl  and 
dp  monl  [1..6,8] 

will  display  all  elements  of  monl  except  the  seventh. 

The  number  of  elements  in  each  monitor  being  output  is  indicated  by  a 
series  of  numbers  in  the  heading  of  each  page.  For  an  example  which 
illustrates  the  format,  see  APPENDIX  2:  the  monitors  myram  and  outval  are 
structures  consisting  of  a  single  element  and  the  monitors  acc  and  address 


are  Cvo  and  four  element  structures  respectively. 

Note  that  In  the  current  version  of  the  tabulator,  sll  structures  have  been 
'flattened';  this  means  that  structures  of  the  form  ([4)  bool,  [A]  bool) 
and  ({7]  bool,  bool)  are  effectively  equivalent  to  [8]  bool  and  should  be 
indexed  as  such. 


3.2  cd 

cd  (clear  display)  clears  the  list  of  monitors  currently  being  displayed. 
There  is  an  optional  name  parameter:  for  example,  if  there  are  three 
monitors  currently  being  displayed  monl,  mon2  and  mon3,  then 

cd  disp 

will  clear  the  display  and  associate  the  monitors  monl,  mon2  and  mon3  with 
the  name  disp.  If  this  particular  display  is  required  again  at  some  time 
in  the  future,  then  it  can  be  recalled  by  the  command 

dp  disp 


3.3  vl 

wi  (window)  command  triggers  the  output,  in  the  same  way  that  the  command 
ti  produces  output  in  the  simulator.  The  main  difference  between  the  two 
is  that  in  the  tabulator  it  is  possible  to  display  values  at  any  time 
earlier  than  the  current  time  without  having  to  restart  at  time  zero  and 
reset  all  the  monitors. 

wi  can  be  given  without  parameters  and  this  sends  output  to  the  screen  over 
the  entire  range  of  the  history  file.  A  more  selective  output  can  be 
specified  in  three  ways: 

wi  ..50 

will  output  changes  in  value  of  the  monitors  currently  being  displayed  from 
the  start  of  the  history  file  until  time  50. 

wi  50.. 

will  produce  output  from  time  50  until  the  end  of  the  history  file  and 
wi  50.. 100 

will  output  changes  between  times  50  and  100. 


3. A  rn 

The  command  rn  (rename)  is  used  to  rename  any  ba>lc  value  name.  It  can  be 
used  either  to  abbreviate  excessively  long  ba6lc  values,  so  that  more 
monitors  can  fit  on  each  screen  width  or  to  generate  simple  waveforms.  For 
an  example  of  rn  which  demonstrates  the  latter  use,  consider  the  command 

rn  f-"0  "  x-M  X  "  t-"  1" 


A 


t 


This  will  generate  a  display  in  which  an  occurrence  of  0  in  the  first 
column  of  the  tabulated  output  represents  f,  X  in  the  second  column 
represents  x  and  1  in  the  third  column  represents  t.  The  effect  of  such  a 
rename  command  on  the  output  can  be  seen  in  APPENDIX  3. 

Note  that  the  new  basic  value  name  is  specified  within  quotes  and  that 
spaces  are  allowed  as  part  of  the  new  name.  The  only  restriction  on  the 
new  name  is  that  it  cannot  include  quote  symbols. 


3.5  ev 

ev  (event)  is  used  to  search  for  the  times  at  which  a  given  event  has 
occurred. 


3.5.1  Single  events 

The  simplest  type  of  event  command  is  of  the  form 
ev  monl  »  t 

(where  monl  is  of  TYPE  bool  and  bool  can  be  either  t,  f  or  x).  All 
instances  of  this  event  will  be  searched  for  and  an  appropriate 
me66age  will  be  sent  to  the  screen:  either  "event  not  found"  if  no 
occurrences  of  the  event  have  been  found,  or  a  message  to  Indicate  at 
what  times  the  event  occurred. 

The  command  to  search  for  either  of  the  basic  values  t  or  f  is 
ev  monl  «  (t | f ) 

The  symbol  'W  can  be  used  for  negation: 
ev  monl  «/\x 

which  incidentally  would  have  the  same  effect  as  the  previous  command. 
It  is  also  possible  to  search  for  the  occurrence  of  question  marks. 


3.5.2  Multiple  events 

The  syntax  for  multiple  events  is  similar  to  the  syntax  for  the  ELLA 
CASE  statement.  For  example,  if  the  monitors  monl,  mon2  and  mon3  are 
of  TYPE  bool,  then  the  command 

ev  (monl,  mon2,  mon3)  »  (t,  t,  t) 

will  search  for  the  basic  value  t  at  all  three  monitors.  More  than 
one  set  of  possibilities  can  be  tested  at  once: 

ev  (monl,  mon2,  mon3)  »  ((t,  t,t)|(f,  f,  f)|(x,  x,  x)) 

will  find  the  times  at  which  all  three  monitors  simultaneously  take  up 
the  same  value. 


Monitors  on  the  lefthandside  of  an  event  expression  can  be  Indexed  as 
described  in  Section  3.1. 


3.5.3  Associated  types 

To  Illustrate  the  use  of  the  event  command  with  associated  types, 
consider  the  declarations 

TYPE  bool  -  NEW  (t|f jx), 

word  »  [8]  bool, 

address  •  NEW  (data  &  wordjlnstr  &  word). 

If  the  monitor  monl  Is  of  TYPE  address,  then  the  command 
ev  (monl//instr)  [1]  ■  t 

will  search  for  the  basic  value  in  the  first  element  if  the  TYPE  word 
associated  with  lnstr. 

Note  that  associated  types  are  recovered  on  the  lefthandslde  of  an 
event  expression;  this  allows  structured  types  (such  as  word  in  the 
above  example)  to  be  Indexed  as  before. 

If  the  monitor  mon2  is  of  type  [2]  address,  then  the  first  or  second 
element  of  the  structure  can  be  selected  by  indexing  before  recovering 
the  associated  type.  For  example 

ev  (mon2  [1]  //instr)  [7]  -  t 

will  search,  in  the  first  element  of  mon2,  for  the  basic  value  t  in 
the  seventh  element  of  TYPE  word  associated  with  lnstr. 


3.6  ja 

fi  exists  the  tabulator  and  re-enters  the  simulator. 
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APPENDIX  1 


***  TIME  -  0  *** 

ADDRESS  -  X  X  X  X,  MYRAM  -  LOAD  X,  ACC  -  1/1  J/0,  OUTVAL  -  V/O 

***  TIME  -  1  *** 

MYRAM  LOAD  F 
***  TIME  m  2  *** 

ADDRESS  F  F  X  X,  ACC  1/2  J/0 
***  TIME  “  3  *** 

ADDRESS  T  F  X  X,  MYRAM  LOAD  T,  ACC  1/2  J/3 

***  TIME  -  4  *** 

ADDRESS  F  F  X  F 

***  TIME  -  5  *** 

ADDRESS  X  F  X  F,  MYRAM  LOAD  F,  ACC  1/4  J/3 

***  TIME  «  6  *** 

ADDRESS  :*  F  F  X  F 

***  TIME  “  7  *** 

ADDRESS  F  F  F  F,  MYRAM  LOAD  T,  ACC  1/6  J/3 

***  TIME  «  8  *** 

ADDRESS  F  T  F  F,  ACC  :«  1/6  J/6 

***  TIME  «  9  *** 

MYRAM  READ  F 
***  TIME  -  10  *** 

ADDRESS:-  TIFF,  ACC  1/8  J/6,  OUTVAL  V/25 
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APPENDIX  3 
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